home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XFillRectangle.z / XFillRectangle
Encoding:
Text File  |  2002-10-03  |  12.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XFillRectangle, XFillRectangles, XFillPolygon, XFillArc,
  10.           XFillArcs - fill rectangles, polygons, or arcs
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XFillRectangle(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Drawable _d;
  16.                 GC _g_c;
  17.                 int _x, _y;
  18.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  19.  
  20.           XFillRectangles(_d_i_s_p_l_a_y, _d, _g_c, _r_e_c_t_a_n_g_l_e_s, _n_r_e_c_t_a_n_g_l_e_s)
  21.                 Display *_d_i_s_p_l_a_y;
  22.                 Drawable _d;
  23.                 GC _g_c;
  24.                 XRectangle *_r_e_c_t_a_n_g_l_e_s;
  25.                 int _n_r_e_c_t_a_n_g_l_e_s;
  26.  
  27.           XFillPolygon(_d_i_s_p_l_a_y, _d, _g_c, _p_o_i_n_t_s, _n_p_o_i_n_t_s, _s_h_a_p_e, _m_o_d_e)
  28.                 Display *_d_i_s_p_l_a_y;
  29.                 Drawable _d;
  30.                 GC _g_c;
  31.                 XPoint *_p_o_i_n_t_s;
  32.                 int _n_p_o_i_n_t_s;
  33.                 int _s_h_a_p_e;
  34.                 int _m_o_d_e;
  35.  
  36.           XFillArc(_d_i_s_p_l_a_y, _d, _g_c,  _x, _y, _w_i_d_t_h, _h_e_i_g_h_t, _a_n_g_l_e_1,
  37.           _a_n_g_l_e_2)
  38.                 Display *_d_i_s_p_l_a_y;
  39.                 Drawable _d;
  40.                 GC _g_c;
  41.                 int _x, _y;
  42.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  43.                 int _a_n_g_l_e_1, _a_n_g_l_e_2;
  44.  
  45.           XFillArcs(_d_i_s_p_l_a_y, _d, _g_c, _a_r_c_s, _n_a_r_c_s)
  46.                 Display *_d_i_s_p_l_a_y;
  47.                 Drawable _d;
  48.                 GC _g_c;
  49.                 XArc *_a_r_c_s;
  50.                 int _n_a_r_c_s;
  51.  
  52.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  53.           _a_n_g_l_e_1    Specifies the start of the arc relative to the
  54.                     three-o'clock position from the center, in units
  55.                     of degrees * 64.
  56.  
  57.           _a_n_g_l_e_2    Specifies the path and extent of the arc relative
  58.                     to the start of the arc, in units of degrees * 64.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _a_r_c_s      Specifies an array of arcs.
  75.  
  76.           _d         Specifies the drawable.
  77.  
  78.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  79.  
  80.           _g_c        Specifies the GC.
  81.  
  82.           _m_o_d_e      Specifies the coordinate mode. You can pass
  83.                     _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n or _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s.
  84.  
  85.           _n_a_r_c_s     Specifies the number of arcs in the array.
  86.  
  87.           _n_p_o_i_n_t_s   Specifies the number of points in the array.
  88.  
  89.           _n_r_e_c_t_a_n_g_l_e_s
  90.                     Specifies the number of rectangles in the array.
  91.  
  92.           _p_o_i_n_t_s    Specifies an array of points.
  93.  
  94.           _r_e_c_t_a_n_g_l_e_s
  95.                     Specifies an array of rectangles.
  96.  
  97.           _s_h_a_p_e     Specifies a shape that helps the server to improve
  98.                     performance.  You can pass _C_o_m_p_l_e_x, _C_o_n_v_e_x, or
  99.                     _N_o_n_c_o_n_v_e_x.
  100.  
  101.           _w_i_d_t_h
  102.           _h_e_i_g_h_t    Specify the width and height, which are the
  103.                     dimensions of the rectangle to be filled or the
  104.                     major and minor axes of the arc.
  105.  
  106.           _x
  107.           _y         Specify the x and y coordinates, which are
  108.                     relative to the origin of the drawable and specify
  109.                     the upper-left corner of the rectangle.
  110.  
  111.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  112.           The _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s functions fill the
  113.           specified rectangle or rectangles as if a four-point
  114.           _F_i_l_l_P_o_l_y_g_o_n protocol request were specified for each
  115.           rectangle:
  116.  
  117.           [x,y] [x+width,y] [x+width,y+height] [x,y+height]
  118.  
  119.           Each function uses the x and y coordinates, width and height
  120.           dimensions, and GC you specify.
  121.  
  122.           _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s fills the rectangles in the order listed in
  123.           the array. For any given rectangle, _X_F_i_l_l_R_e_c_t_a_n_g_l_e and
  124.           _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s do not draw a pixel more than once. If
  125.           rectangles intersect, the intersecting pixels are drawn
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           multiple times.
  141.  
  142.           Both functions use these GC components: function, plane-
  143.           mask, fill-style, subwindow-mode, clip-x-origin, clip-y-
  144.           origin, and clip-mask.  They also use these GC mode-
  145.           dependent components: foreground, background, tile, stipple,
  146.           tile-stipple-x-origin, and tile-stipple-y-origin.
  147.  
  148.           _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s can generate _B_a_d_D_r_a_w_a_b_l_e,
  149.           _B_a_d_G_C, and _B_a_d_M_a_t_c_h errors.
  150.  
  151.           _X_F_i_l_l_P_o_l_y_g_o_n fills the region closed by the specified path.
  152.           The path is closed automatically if the last point in the
  153.           list does not coincide with the first point.  _X_F_i_l_l_P_o_l_y_g_o_n
  154.           does not draw a pixel of the region more than once.
  155.           _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as relative to the
  156.           origin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s treats all coordinates after
  157.           the first as relative to the previous point.
  158.  
  159.           Depending on the specified shape, the following occurs:
  160.  
  161.           +o    If shape is _C_o_m_p_l_e_x, the path may self-intersect. Note
  162.                that contiguous coincident points in the path are not
  163.                treated as self-intersection.
  164.  
  165.           +o    If shape is _C_o_n_v_e_x, for every pair of points inside the
  166.                polygon, the line segment connecting them does not
  167.                intersect the path.  If known by the client, specifying
  168.                _C_o_n_v_e_x can improve performance. If you specify _C_o_n_v_e_x
  169.                for a path that is not convex, the graphics results are
  170.                undefined.
  171.  
  172.           +o    If shape is _N_o_n_c_o_n_v_e_x, the path does not self-
  173.                intersect, but the shape is not wholly convex. If known
  174.                by the client, specifying _N_o_n_c_o_n_v_e_x instead of _C_o_m_p_l_e_x
  175.                may improve performance. If you specify _N_o_n_c_o_n_v_e_x for a
  176.                self-intersecting path, the graphics results are
  177.                undefined.
  178.  
  179.           The fill-rule of the GC controls the filling behavior of
  180.           self-intersecting polygons.
  181.  
  182.           This function uses these GC components: function, plane-
  183.           mask, fill-style, fill-rule, subwindow-mode, clip-x-origin,
  184.           clip-y-origin, and clip-mask.  It also uses these GC mode-
  185.           dependent components: foreground, background, tile, stipple,
  186.           tile-stipple-x-origin, and tile-stipple-y-origin.
  187.  
  188.           _X_F_i_l_l_P_o_l_y_g_o_n can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C, _B_a_d_M_a_t_c_h, and
  189.           _B_a_d_V_a_l_u_e errors.
  190.  
  191.           For each arc, _X_F_i_l_l_A_r_c or _X_F_i_l_l_A_r_c_s fills the region closed
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXFFFFiiiillllllllRRRReeeeccccttttaaaannnngggglllleeee((((3333XXXX11111111))))
  203.  
  204.  
  205.  
  206.           by the infinitely thin path described by the specified arc
  207.           and, depending on the arc-mode specified in the GC, one or
  208.           two line segments. For _A_r_c_C_h_o_r_d, the single line segment
  209.           joining the endpoints of the arc is used. For _A_r_c_P_i_e_S_l_i_c_e,
  210.           the two line segments joining the endpoints of the arc with
  211.           the center point are used. _X_F_i_l_l_A_r_c_s fills the arcs in the
  212.           order listed in the array. For any given arc, _X_F_i_l_l_A_r_c and
  213.           _X_F_i_l_l_A_r_c_s do not draw a pixel more than once. If regions
  214.           intersect, the intersecting pixels are drawn multiple times.
  215.  
  216.           Both functions use these GC components: function, plane-
  217.           mask, fill-style, arc-mode, subwindow-mode, clip-x-origin,
  218.           clip-y-origin, and clip-mask.  They also use these GC mode-
  219.           dependent components: foreground, background, tile, stipple,
  220.           tile-stipple-x-origin, and tile-stipple-y-origin.
  221.  
  222.           _X_F_i_l_l_A_r_c and _X_F_i_l_l_A_r_c_s can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C, and
  223.           _B_a_d_M_a_t_c_h errors.
  224.  
  225.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  226.           _B_a_d_D_r_a_w_a_b_l_e
  227.                     A value for a Drawable argument does not name a
  228.                     defined Window or Pixmap.
  229.  
  230.           _B_a_d_G_C     A value for a GContext argument does not name a
  231.                     defined GContext.
  232.  
  233.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  234.  
  235.           _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct
  236.                     type and range but fails to match in some other
  237.                     way required by the request.
  238.  
  239.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  240.                     values accepted by the request.  Unless a specific
  241.                     range is specified for an argument, the full range
  242.                     defined by the argument's type is accepted.  Any
  243.                     argument defined as a set of alternatives can
  244.                     generate this error.
  245.  
  246.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  247.           XDrawArc(3X11), XDrawPoint(3X11), XDrawRectangle(3X11)
  248.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.